<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<HEAD>
     <TITLE>Tr</TITLE>
     <link rel="stylesheet" type="text/css" href="../../../ss/2.css" id="thecss">
     <script type="text/javascript" src="../../../scripts/csschange.js"></script>
</HEAD>

<BODY onload="readSS()">

<br>
<center>
<table border=3 cellpadding=5 cellspacing=0>
<tr>
     <td><h1 class="pagetitle">Table Row</h1>
         <b><a href="../../../misc/suppkey.htm">Support Key:</a></b> 
         [<span class="ns">2</span>|<b><i class="fs">3</i></b>|<b class="s">3.2</b>|<b class="s">4</b>] 
         [<b class="s">X1</b>|<b class="s">X1.1</b>]
         [<b class="s">IE2</b>|<b><i class="fs">M2A8</i></b>|<b class="s">N1.1</b>|<b class="s">O2.1</b>]</td>
     <td><a href="#what">What is it?</a><br>
         <a href="#attrib">Attributes</a><br>
         <a href="#example">Tag Example</a>
     </td>
     <td><a href="#model">Parent/Content Model</a><br>
         <a href="#tips">Tips &amp; Tricks</a><br>
         <a href="#peculiar">Browser Peculiarities</a></td>
</tr>
<tr><td align=center colspan=3>
<font size=2>= <span class="sitetitle">Index DOT Html</span> by <a href="../../../misc/email.htm">Brian Wilson</a> =</font>
</td></tr>
</table>

<font size=2>
     <a href="../../index.html">Main Index</a> |
     <a href="../../tree/htmltree.htm">Element Tree</a> |
     <a href="../../tagindex/a.htm">Element Index</a> |
     <a href="../../supportkey/a.htm">HTML Support History</a></font>
</center>
<hr align="center" width="25%">

<br><br>
<table border=1 cellspacing=0 cellpadding=5>
<tr><td>
<table border=0 cellspacing=0>
<tr>
    <th colspan=3 valign=bottom class="field"><big><u><b
        class="colheaders">&#160;&#160;&#160;Quick Statistics&#160;&#160;&#160;</b></u></big><br></th>
</tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#et">End Tag:</a></b><br></th>
    <td rowspan=7>&nbsp;&nbsp;</td>
    <td><span class="magicword">Optional</span></td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b><br></th>
    <td>In all HTML 4.x/XHTML DTDs</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#xhtm">XHTML Modules:</a></b><br></th>
    <td><b class=alert>Basic Tables</b>, <b class=alert>Tables</b></td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#disp">CSS 'display' Type:</a></b><br></th>
    <td>"<b class="alert">table-row</b>"</td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#css">CSS Mapping:</a></b><br></th>
    <td>NA</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#rnd">Default Rendering:</a></b><br></th>
    <td>NA</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#w3docs">Official Docs:</a></b><br></th>
    <td><a href="http://www.w3.org/TR/html401/struct/tables.html#h-11.2.5">HTML 4.x</a>, 
        <a href="http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_tablemodule">XHTML 1.1</a></td></tr>
</table>
</td></tr>
</table>

<br>
<a name="what"></a>
<dl>
<dt><big><b class="mainheading">What is it?</b></big>
    <dd>The TR element is a part of the original
        <a href="../tables.htm#simple">Simple Table Model</a> and is also part of
        the newer, backward compatible <a href="../tables.htm#complex">Complex
        Table Model</a>. It is a table structuring element that provides a
        grouping scheme for individual table cells by table row.
</dl>


<a name="attrib"></a>
<dl>
<dt><big><b class="mainheading">Common Attributes</b></big>
<dt><b class="subheading">%<a href="../attributes/core.htm">Core</a>%</b>
    <dd>[<span class="ns">2</span>|<b><i class="fs">3</i></b>|<span class="ns">3.2</span>|<b class="s">4</b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE3</i></b>|<span class="ns">M</span>|<b class="s">N4B2</b>|<b class="s">O3.5</b>]

<dt><b class="subheading">%<a href="../attributes/accessibility.htm">Accessibility</a>%</b>
    <dd><span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4B1</i></b>|<span class="ns">M</span>|<b class="s">N6</b>|<b class="s">O5</b>]

<dt><b class="subheading">%<a href="../attributes/events.htm">Events</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4B1</i></b>|<span class="ns">M</span>|<b class="s">N6B1</b>|<b class="s">O4</b>]

<dt><b class="subheading">%<a href="../attributes/language.htm">Language</a>%</b>
    <dd>[<span class="ns">2</span>|<b><i class="fs">3</i></b>|<span class="ns">3.2</span>|<b class="s">4</b>] 
        [<b class="s">X1</b>|<b class="s">X1.1</b>]
        [<b><i class="fs">IE4</i></b>|<span class="ns">M</span>|<b class="s">N6B1</b>|<span class="ns">O</span>]

<dt><b class="subheading">%<a href="../attributes/editing.htm">Editing</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
        [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
        [<b><i class="fs">IE5.5</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]

<dt><br><big><b class="mainheading">Specific Attributes</b></big>
<dt><b class="subheading">Align</b>
<dt>[<span class="ns">2</span>|<b><i class="fs">3</i></b>|<b class="s">3.2</b>|<b class="s">4</b>] 
    [<b class="s">X1</b>|<b class="s">X1.1</b>]
    [<b class="s">IE2</b>|<b><i class="fs">M2A8</i></b>|<b class="s">N1.1</b>|<b class="s">O2.1</b>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        In all HTML 4.x/XHTML DTDs
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute specifies the global horizontal alignment of each
        of the cells in this current row.
    <dd><b class="l3heading">Values:</b> <b class="alert">Left</b> | <b class="alert">Center</b> |
        <b class="alert">Right</b> | <b class="alert">Justify</b> | <b class="alert">Char</b>

<dt><b class="subheading">Background</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
    [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
    [<span class="ns">IE</span>|<span class="ns">M</span>|<b><i class="fs">N4</i></b>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> NA
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute specifies a background image to be placed in the current
        table cell. All cell contents will be displayed over this image. If the
        referenced image is smaller than the table cell size, it will be tiled to
        fit all of the cell area. The value for this attribute indicates the URL
        to reference the graphic.
    <dd><b class="l3heading">Values:</b>
        Either an absolute or relative URL. All URLs should be <a
        href="../../topics/urlencoding.htm">URL encoded</a> where required.

<dt><b class="subheading">BGColor</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
    [<b class="s">X1</b>|<span class="ns">X1.1</span>]
    [<b><i class="fs">IE2</i></b>|<span class="ns">M</span>|<b class="s">N3B1</b>|<b class="s">O2.1</b>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        Deprecated in HTML 4.x/XHTML 1.0. Dropped in XHTML 1.1 in favor of CSS.
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute sets the background color to be used for each cell in
        this current row of table cells.
    <dd><b class="l3heading">Values:</b> <a href="../../../misc/glossary.htm#cdata">CDATA</a>.
        [The standard <a href="../../../color/colors.htm">HTML color specification</a> method values apply.]

<dt><b class="subheading">BorderColor</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
    [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
    [<b><i class="fs">IE2</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> NA
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute sets the internal border color to be used for each cell
        in this current row of table cells. Display of this attribute is
        dependent on the presence of the BORDER attribute in the
        <a href="table.htm">TABLE</a> element.
    <dd><b class="l3heading">Values:</b>
        The standard <a href="../../../color/colors.htm">HTML color specification</a> methods.

<dt><b class="subheading">BorderColorDark</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
    [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
    [<b><i class="fs">IE2</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> NA
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute allows independent, 3-D color control over the upper
        and left hand borders of the internal cell border color for each cell
        in this current row of table cells. To change the lower and right hand
        borders of the internal cell border color for each cell in the current
        row, use the BorderColorLight attribute (see below.) Display of this
        attribute is dependent on the presence of the BORDER attribute in the
        <a href="table.htm">TABLE</a> element.
    <dd><b class="l3heading">Values:</b>
        The standard <a href="../../../color/colors.htm">HTML color specification</a> methods.

<dt><b class="subheading">BorderColorLight</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
    [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
    [<b><i class="fs">IE2</i></b>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> NA
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute allows independent, 3-D color control over the lower and
        right hand borders of the internal cell border color for each cell in
        this current row of table cells. To change the upper and left hand
        borders of the internal cell border color for each cell in the current
        row, use the BorderColorDark attribute (see above.) Display of this
        attribute is dependent on the presence of the BORDER attribute in the
        <a href="table.htm">TABLE</a> element.
    <dd><b class="l3heading">Values:</b>
        The standard <a href="../../../color/colors.htm">HTML color specification</a> methods.

<dt><b class="subheading">Char</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
    [<b class="s">X1</b>|<b class="s">X1.1</b>]
    [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        In all HTML 4.x/XHTML DTDs
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute specifies a character in the content of each cell of the current
        row to be used to align the cell content (the first occurrence of the character
        should be used.) The default value for this attribute is the decimal point
        character for the current specified language.
    <dd><b class="l3heading">Values:</b> <a href="../../../misc/glossary.htm#cdata">CDATA</a>.

<dt><b class="subheading">Charoff</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<b><i class="fs">4</i></b>] 
    [<b class="s">X1</b>|<b class="s">X1.1</b>]
    [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        In all HTML 4.x/XHTML DTDs
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute specifies the spacing offset to the first occurrence of the
        alignment character (specified by the CHAR attribute) on each line of the
        cells in the current row. The direction of the offset is determined by the
        current text direction (set with the DIR attribute or the BDO element.)
    <dd><b class="l3heading">Values:</b> <a href="../../../misc/glossary.htm#cdata">CDATA</a>.
        [Integers indicating pixel offset values.]

<dt><b class="subheading">Height</b>
<dt>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
    [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
    [<b><i class="fs">IE5</i></b>|<span class="ns">M</span>|<b class="s">N6B3</b>|<b class="s">O4</b>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> NA
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This attribute explicitly specifies the height of this table row in pixels.
    <dd><b class="l3heading">Values:</b> Positive integers.

<dt><b class="subheading">NOWRAP</b>
<dt>[<span class="ns">2</span>|<b><i class="fs">3</i></b>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
    [<span class="ns">X1</span>|<span class="ns">X1.1</span>]
    [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<b><i><u class="sr">O2.1-3.2x</u></i></b>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> NA
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        This is a standalone attribute which specifies that the data within the
        current row will not use normal HTML linebreaking conventions. The
        table cells in the row will enlarge to fit whatever data is specified in
        the cells (unless explicit linebreaking elements are used.)
    <dd><b class="l3heading">Values:</b> NA

<dt><b class="subheading">VAlign</b>
<dt>[<span class="ns">2</span>|<b><i class="fs">3</i></b>|<b class="s">3.2</b>|<b class="s">4</b>] 
    [<b class="s">X1</b>|<b class="s">X1.1</b>]
    [<b class="s">IE2</b>|<b><i class="fs">M2A8</i></b>|<b class="s">N1.1</b>|<b class="s">O2.1</b>]
    <dd><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b> 
        In all HTML 4.x/XHTML DTDs
    <dd><b class="l3heading">Required?</b> No
    <dd><b class="l3heading">Description:</b><br>
        The VAlign attribute specifies the global vertical alignment of each of
        the cells in the current row.
    <dd><b class="l3heading">Values:</b> <b class="alert">Top</b> | <b class="alert">Middle</b> |
      <b class="alert">Bottom</b> | <b class="alert">Baseline</b>
</dl>


<a name="example"></a>
<dl>
<dt><big><b class="mainheading">Example</b></big><br>
    [Using the <a href="../tables.htm#simple">Simple Table Model</a>]
    <dd><div class="example">&lt;<b class="tagname">table</b> 
        <span class="tagattrib">border</span>=&quot;2&quot;
        <span class="tagattrib">align</span>=&quot;left&quot;
        <span class="tagattrib">cellpadding</span>=&quot;5&quot;<br>
        <span class="tagattrib">bordercolor</span>=&quot;#ff0000&quot;
        <span class="tagattrib">width</span>=&quot;75%&quot;&gt;<br>
        &#160;&#160;&#160;&#160;&#160;&#160;&lt;<b class="tagname">caption</b>
        <span class="tagattrib">align</span>=&quot;top&quot;&gt;Juggling Capabilities of Waterfront
        Performers&lt;/<b class="tagname">caption</b>&gt;<br>
        &#160;&#160;&#160;&#160;&#160;&#160;&lt;<b class="tagname">tr</b>&gt;
        &lt;<b class="tagname">th</b>&gt;Juggler&lt;/<b class="tagname">th</b>&gt;&lt;<b
        class="tagname">th</b>&gt;Pins&lt;/<b class="tagname">th</b>&gt;&lt;<b class="tagname">th</b>&gt;Bowling
        Balls&lt;/<b class="tagname">th</b>&gt;&lt;<b class="tagname">th</b>&gt;Flaming
        Baseballs&lt;/<b class="tagname">th</b>&gt; &lt;/<b class="tagname">tr</b>&gt;<br>
        &#160;&#160;&#160;&#160;&#160;&#160;&lt;<b class="tagname">tr</b>&gt;
        &lt;<b class="tagname">td</b>&gt;Bob&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;5&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;2&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;5&lt;/<b class="tagname">td</b>&gt;
        &lt;/<b class="tagname">tr</b>&gt;<br>
        &#160;&#160;&#160;&#160;&#160;&#160;&lt;<b class="tagname">tr</b>&gt;
        &lt;<b class="tagname">td</b>&gt;Larry&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;2&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;7!!!&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;NA&lt;/<b class="tagname">td</b>&gt;
        &lt;/<b class="tagname">tr</b>&gt;<br>
        &#160;&#160;&#160;&#160;&#160;&#160;&lt;<b class="tagname">tr</b>&gt;
        &lt;<b class="tagname">td</b>&gt;Julie the Great&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;1&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;2&lt;/<b class="tagname">td</b>&gt;
        &lt;<b class="tagname">td</b>&gt;20&lt;<b class="tagname">br</b>&gt;(She IS
        great!)&lt;/<b class="tagname">td</b>&gt; &lt;/<b class="tagname">tr</b>&gt;<br>
        &#160;&#160;&#160;&#160;&#160;&#160;&lt;<b class="tagname">tr</b>&gt; &lt;<b class="tagname">th</b>
        <span class="tagattrib">colspan</span>=&quot;4&quot;&gt;NOTE: This is only a small
        sample&lt;/<b class="tagname">th</b>&gt; &lt;/<b class="tagname">tr</b>&gt;<br>
        &lt;/<b class="tagname">table</b>&gt;</div>
</dl>


<a name="model"></a>
<dl>
<dt><big><b class="mainheading">Parent Model</b></big>
    <dd>&lt;<a href="../t/table.htm">table</a>&gt; |
        &lt;<a href="../t/tbody.htm">tbody</a>&gt; |
        &lt;<a href="../t/thead.htm">thead</a>&gt; |
        &lt;<a href="../t/tfoot.htm">tfoot</a>&gt;
<dt><big><b class="mainheading">Content Model</b></big>
    <dd>&lt;<a href="../t/thtd.htm">th</a>&gt; |
        &lt;<a href="../t/thtd.htm">td</a>&gt;
</dl>


<a name="tips"></a>
<big><b class="mainheading">Tips &amp; Tricks</b></big>
<ul>
    <li>The HTML Tables specification says that end tags for the TR element
        are not necessary. Browsers are typically more stringent with regards
        to processing table structures - it is a very good idea to explicitly
        close all table structure elements that have "optional" end tags. This
        also gives your markup better readability and it can also help to
        reduce confusion in case you need to edit your HTML pages by hand.
    <li>Make sure that the only content of your top-level TABLE elements are
        TR elements or other valid organizational structures.
        Also make sure that the only content of your TRs are
        <a href="thtd.htm">TH or TD</a> elements. Otherwise, some browsers may
        display table contents incorrectly.
    <li>The Table model (even the Simple Table Model) is easily the most
        complex markup structure in HTML. If you have general questions about
        this structure see the <a href="../tables.htm">Table Overview</a>.
    <li>If you are having problems with table layout and borders are turned
        off, it can be helpful to temporarily turn them on - this can reveal
        clues of why the layout is misbehaving.
    <li><b class="alert">DTD Note:</b> HTML 3.2 did not contain the 'baseline'
        value for the VALIGN attribute.
    <li><b class="alert">Compatibility Tip:</b>
        To enable Table cell contents to display well on browsers that do not
        support tables, it is common practice to put either an extra space at
        the end of each table cell, or even better, put a
        &lt;<b class="tagname">br</b>&gt; element at the end of the last cell in
        each table row (eg: &lt;tr&gt; &lt;td&gt;cell 1&lt;/td&gt; &lt;td&gt;cell
        2&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;.) This is perfectly legal HTML and
        should cause no display problems for browsers that support tables (as
        there is an implied line break anyway at the end of every table cell)
        and should greatly improve readability on older browsers. 
</ul>

<a name="peculiar"></a>
<big><b class="mainheading">Browser Peculiarities</b></big>
<ul>
    <li>The latest Internet Explorer documentation states that WIDTH is a valid
        attribute for this element, but my testing in all of the major versions
        can not confirm this.
    <li>Opera 3.5-3.6x appears to not support the WRAP attribute. Opera versions
        before and after this support it though.
    <li><a href="../../../testing/html/tags/t/tr-bp1.htm">[Test]</a>
        Netscape 4.x error condition bug: if a BGCOLOR and BACKGROUND attribute
        have been specified for the row, and the URL to the image fails to
        load, the bgcolor should be used instead. Netscape 4.x does that for
        a moment, but then this changes to a block only the size of the broken
        image placeholder with the specified BGCOLOR in the upper, left corner
        of each of the cells in the row.
</ul>


<br>
<a href="../../../misc/copyright.htm">Boring Copyright Stuff...</a>

</BODY>
</HTML>